package com.xyrl.project.common.common.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.xyrl.common.base.exception.XyrlException;
import com.xyrl.project.common.common.entity.Attachment;
import com.xyrl.project.common.common.enu.AttImageUseType;
import com.xyrl.project.common.common.vo.AttachmentVo;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * @author zhongp
 * @version 1.0
 * @className AttachmentService.java
 * @company 重庆星纭融链科技公司
 * @date 2019-12-27 16:39:32
 * @Description 附件
 */
public interface AttachmentService extends IService<Attachment> {
    /**
     * 添加附件
     *
     * @param file     附件文件
     * @param userId   操用用户
     * @param userType 用户类型
     * @param module   文件类型
     * @return
     */
    AttachmentVo addAttachment(MultipartFile file, Long userId, String userType, String module) throws XyrlException;

    /**
     * 根据id读取附件
     *
     * @param id
     * @author 徐恩源
     * @date 2020-01-05 10:06:41
     */
    AttachmentVo findById(long id);

    /**
     * @param ids
     * @return
     */
    List<AttachmentVo> findListByIdList(List<Long> ids);

    /**
     * 根据路径查询附件
     *
     * @param path
     * @author 徐恩源
     * @date 2020-01-06 17:38:57
     */
    AttachmentVo findByPath(String path);

    /***
     * 根据路径查询附件
     * @author 徐恩源
     * @date 2020-01-06 17:39:09
     * @param pathList
     */
    List<AttachmentVo> findListByPathList(List<String> pathList);

    /**
     * 处理附件使用
     * 添加新使用记录
     * 删除旧使用记录
     *
     * @param useId    使用id
     * @param useType  使用类型
     * @param addAttId 添加附件id
     * @param delAttId 删除附件id（可空）
     * @author 徐恩源
     * @date 2020-01-07 10:16:49
     */
    void handleAttImageUseAttId(long useId, AttImageUseType useType, long addAttId, Long delAttId);

    /**
     * 添加附件使用
     *
     * @param useId    使用id
     * @param useType  使用类型
     * @param addAttId 附件id
     */
    void handleAttImageUseAttId(long useId, AttImageUseType useType, long addAttId);

    /**
     * 处理附件使用
     * 添加新使用记录
     * 删除旧使用记录
     *
     * @param useId      使用id
     * @param useType    使用类型
     * @param addAttPath 添加附件路径
     * @param delAttPath 删除附件路径（可空）
     * @author 徐恩源
     * @date 2020-01-07 10:16:49
     */
    void handleAttImageUsePath(long useId, AttImageUseType useType, String addAttPath, String delAttPath);

    /**
     * 处理附件使用
     * 添加新使用记录
     * 删除旧使用记录
     *
     * @param useId        使用id
     * @param useType      使用类型
     * @param addAttIdList 添加附件id
     * @param delAttIdList 删除附件id（可空）
     * @author 徐恩源
     * @date 2020-01-07 10:16:49
     */
    void handleAttImageUseAttId(long useId, AttImageUseType useType, List<Long> addAttIdList, List<Long> delAttIdList);

    /**
     * 处理附件使用
     * 添加新使用记录
     * 删除旧使用记录
     *
     * @param useId
     * @param useType
     * @param addAttPathList 添加附件路径
     * @param delAttPathList 删除附件路径
     * @author 徐恩源
     * @date 2020-01-07 10:36:38
     */
    void handleAttImageUsePath(long useId, AttImageUseType useType, List<String> addAttPathList, List<String> delAttPathList);

    /**
     * 图片使用场景变更
     * 添加新使用记录
     * 删除旧使用记录
     *
     * @param useId      使用id
     * @param useType    使用类型
     * @param addAttPath 添加附件路径 （可空）
     * @param delAttPath 删除附件路径（可空）
     * @author 徐恩源
     * @date 2020-01-07 10:16:49
     */
    void changeImageUsePath(long useId, AttImageUseType useType, String addAttPath, String delAttPath);
}
